home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 October: Mac OS SDK / Dev.CD Oct 00 SDK1.toast / Development Kits / Mac OS / Multiprocessing 2.1v2 SDK / Sample Code / MP Sort Picts 12⁄04⁄99 / old README < prev   
Encoding:
Text File  |  1997-02-04  |  3.9 KB  |  99 lines  |  [ttro/ttxt]
  1. Modified for MP by Matthew Xavier Mora mxmora@apple.com
  2.  
  3. 1/24/97
  4.  
  5.  
  6.  
  7. README for SortPicts 3.0
  8. November 16, 1994
  9. Randy Thelen
  10. AppleLink: RANDOM
  11. Internet: random@apple.com
  12.  
  13. SortPicts is an entertaining application which demonstrates how easy it is to use threads within your application.
  14.  
  15. There are a couple of gotcha's with the build process:
  16. •    If your version of MetroWerks is earlier than 1.1, you may need to rebuild the projects yourself.  If that's the case, you'll find the complete listing of included files and settings at the bottom of this document.
  17. •    If you are building with Think-C, you will need to construct your own projects.  In that case, you'll want to follow the advice at the bottom of this document regarding building a SortPicts project.
  18. •    Various MPW versions and headers may cause you random headaches.  The supplied version of SortPicts sources were built with the 3.4a7 MPW Shell from ETO #16 along with the headers from that release.  If you are using a different version, you may experience problems.
  19.  
  20. Making a SortPicts project.
  21.     The following files were included to make the SortPicts projects:
  22. For both 68K & PPC:
  23.     SortPictsApp.cp
  24.     SortPicts.cp
  25.     SortPicts2.cp
  26.     SortPicts3.cp
  27.     SortPicts4.cp
  28.     SortPicts5.cp
  29.     SortPictsThreads.cp
  30.     HeapSort.cp
  31.     QuickSort.cp
  32.     ShellSort.cp
  33.     AppleEventHandling.cp
  34.     SprocketMain.cp
  35.     DialogUtils.cp
  36.     Preferences.cp
  37.     SplashWindow.cp
  38.     Window.cp
  39.     SortPicts.rsrc
  40.     Sprocket.rsrc
  41. For 68K the following libraries were used:
  42.     ANSI (4i) C.68K.Lib
  43.     CPlusPlus.lib
  44.     MacOS.lib
  45. For PPC the following libraries were used:
  46.     InterfaceLib
  47.     ANSI C.PPC.Lib
  48.     MWCRuntime.Lib
  49.     AOCELib            -- Weak link
  50.     DragLib            -- Weak link
  51.     ThreadsLib        -- Weak link
  52.  
  53. There is a precompiled file that will greatly enhance your build time if you go ahead and precompile it.  The file is located in the "Precompiled Headers" folder.  It is a .cp file and will build under MetroWerks correctly.  If you don't already know, you'll need to build two files, one for 68K and one for PPC.  The names that we suggest (like, we used these names in the supplied projects) are SortPictsPrecompileMW68K and SortPictsPrecompileMWPPC.  Although, you're free to make them Cat and Mouse.  We really don't care.
  54.  
  55.     The following "settings" were used to build the file:
  56. Language Settings:
  57.     Activate C++ Compiler
  58.     Require Function Prototypes
  59.     Enable MPW Pointer Type Rules
  60.     <Don't forget the beauty of precompiled headers!>
  61. Warnings:
  62.     Turn all the warnings on -- that's just good advice
  63. Compiler:
  64.     4 byte ints
  65.     Small Code Model
  66.     68K Struct Alignment, even with the PPC version
  67.     68020 code generation, not with the PPC version  ;-)
  68.     Peephole Optimizer
  69.     CSE Optimizer
  70. Linker Options:
  71.     Use SYM file generation only if you need it ... if you find a bug, you might think to let me know  -- Random
  72. Project:
  73.     Build an application
  74.     Call it Cat, Mouse, or SortPicts68K or SortPictsPPC  -- one or the other, MPW builds "SortPicts"
  75.     Creator 'RnDm', type 'APPL'
  76.     Prefered heap size 2000K, minimum heap size 1000K
  77.     Other SIZE resource options:
  78.         dontSaveScreen,
  79.         acceptSuspendResumeEvents,
  80.         enableOptionSwitch,
  81.         canBackground,                /* Can properly use background null events    */
  82.         doesActivateOnFGSwitch,        /* We do our own activate/deactivate; don't fake us out */
  83.         backgroundAndForeground,    /* This is definitely not a background-only application! */
  84.         dontGetFrontClicks,            /* Change this is if you want "do first click" behavior like the Finder */
  85.         ignoreAppDiedEvents,        /* Essentially, I'm not a debugger (sub-launching) */
  86.         is32BitCompatible,            /* This app can be run in 32-bit address space */
  87.         isHighLevelEventAware,        /* does Post/AcceptHighLevelEvent */
  88.         localAndRemoteHLEvents,
  89.         notStationeryAware,
  90.         dontUseTextEditServices
  91. No additional access paths were necessary for this build.
  92. For the PowerPC version, the following additional steps may be helpful:
  93.     There were no variations on the default settings for a PPC build file:
  94.         64K stack size and  main entry point is __start.
  95.  
  96. “Keep on Threadin’”
  97. Randy & Dave
  98.  
  99.